home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / man / lib.fmt / c / link.man < prev    next >
Encoding:
Text File  |  1989-02-08  |  3.4 KB  |  133 lines
  1.  
  2.  
  3.  
  4. LINK                  C Library Procedures                   LINK
  5.  
  6.  
  7.  
  8. NNAAMMEE
  9.      link - make a hard link to a file
  10.  
  11. SSYYNNOOPPSSIISS
  12.      lliinnkk((nnaammee11,, nnaammee22))
  13.      cchhaarr **nnaammee11,, **nnaammee22;;
  14.  
  15. DDEESSCCRRIIPPTTIIOONN
  16.      A hard link to _n_a_m_e_1 is created; the link has the name
  17.      _n_a_m_e_2.  _N_a_m_e_1 must exist.
  18.  
  19.      With hard links, both _n_a_m_e_1 and _n_a_m_e_2 must be in the same
  20.      file system.  Unless the caller is the super-user, _n_a_m_e_1
  21.      must not be a directory.  Both the old and the new _l_i_n_k
  22.      share equal access and rights to the underlying object.
  23.  
  24. RREETTUURRNN VVAALLUUEE
  25.      Upon successful completion, a value of 0 is returned.  Oth-
  26.      erwise, a value of -1 is returned and _e_r_r_n_o is set to indi-
  27.      cate the error.
  28.  
  29. EERRRROORRSS
  30.      _L_i_n_k will fail and no link will be created if one or more of
  31.      the following are true:
  32.  
  33.      [ENOTDIR]      A component of either path prefix is not a
  34.                     directory.
  35.  
  36.      [EINVAL]       Either pathname contains a character with the
  37.                     high-order bit set.
  38.  
  39.      [ENAMETOOLONG] A component of either pathname exceeded 255
  40.                     characters, or entire length of either path
  41.                     name exceeded 1023 characters.
  42.  
  43.      [ENOENT]       A component of either path prefix does not
  44.                     exist.
  45.  
  46.      [EACCES]       A component of either path prefix denies
  47.                     search permission.
  48.  
  49.      [EACCES]       The requested link requires writing in a
  50.                     directory with a mode that denies write per-
  51.                     mission.
  52.  
  53.      [ELOOP]        Too many symbolic links were encountered in
  54.                     translating one of the pathnames.
  55.  
  56.      [ENOENT]       The file named by _n_a_m_e_1 does not exist.
  57.  
  58.      [EEXIST]       The link named by _n_a_m_e_2 does exist.
  59.  
  60.  
  61.  
  62.  
  63. Sprite v1.0              August 26, 1985                        1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. LINK                  C Library Procedures                   LINK
  71.  
  72.  
  73.  
  74.      [EPERM]        The file named by _n_a_m_e_1 is a directory and
  75.                     the effective user ID is not super-user.
  76.  
  77.      [EXDEV]        The link named by _n_a_m_e_2 and the file named by
  78.                     _n_a_m_e_1 are on different file systems.
  79.  
  80.      [ENOSPC]       The directory in which the entry for the new
  81.                     link is being placed cannot be extended
  82.                     because there is no space left on the file
  83.                     system containing the directory.
  84.  
  85.      [EDQUOT]       The directory in which the entry for the new
  86.                     link is being placed cannot be extended
  87.                     because the user's quota of disk blocks on
  88.                     the file system containing the directory has
  89.                     been exhausted.
  90.  
  91.      [EIO]          An I/O error occurred while reading from or
  92.                     writing to the file system to make the direc-
  93.                     tory entry.
  94.  
  95.      [EROFS]        The requested link requires writing in a
  96.                     directory on a read-only file system.
  97.  
  98.      [EFAULT]       One of the pathnames specified is outside the
  99.                     process's allocated address space.
  100.  
  101. SSEEEE AALLSSOO
  102.      symlink(2), unlink(2)
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129. Sprite v1.0              August 26, 1985                        2
  130.  
  131.  
  132.  
  133.